Set the Data Version

Change the data version that is used in your project.

A data version is an instance of uploaded data. Data versions are generated by a job, which is a set of instructions to create the data version. When working in a project, you may want to change the data version when you want to:

  • Preview a new data version that was generated on an ad hoc basis before releasing it to production.
  • Release a specific data version to production.

Note: If the data version release behavior is set to Auto-release latest, you don't have to change the data version of your project in order to preview the new data version. The latest data version that is generated by a job in your project will automatically be applied. For more information, see Release Behavior.

  1. In a project, on the navigation bar, click Data > Data Categories.

  2. In the Data Categories room, click the Actions button  on the right side of the data category that is used to generate data versions for your solution, and then click Edit.

  3. In the Release tab change the data version by doing one of the following:

    Release behavior Do this
    If your release behavior is set to manual release
    1. Click the Data version list to see a list of available data versions.
    2. Select the data version you want to preview or release.
    If your release behavior is set to custom release

    In the Custom data version box, enter the data version you want to preview or release. For example, if the unique identifier of the data version that was just generated is 7000127, you would enter the following: data=7000127.

    If the data version is for the primary data category, use data=. If the data version is not for the primary data category, use the data category's object name; for example, my_data_category=7000128. For more information, see Data Categories.

    You can set data versions from multiple data categories with a comma separator; for example, data=7000127,my_data_category=7000128.

    Tip: Before you edit the data version, you can find the unique identifier of the data version that was just generated by expanding the job name. In this example, 7000127 is the unique identifier of the latest data version that was generated successfully.

  4. When finished, click Update.

    Result: You can preview the selected data version by clicking Preview Solution on the navigation bar. Once you've validated the data version, you can release the data version to production by publishing your project.